home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 63.zip / BS1 part 63 / DC-paint v1.1.adf / DCPaint.doc < prev    next >
Text File  |  1992-09-02  |  10KB  |  366 lines

  1. *************************************************************************
  2. *                ------------                *
  3. *                DCPAINT V1.1                *
  4. *                ------------                *
  5. *                                    *
  6. *                  ALL CODE BY O.S.D                *
  7. *                                    *
  8. *               ORIGINAL IDEA BY SCHITZO            *
  9. *                                    *
  10. *    THERE ARE TWO VERSIONS OF DCPAINT A 1.3 VERSION AND A 2.0+    *
  11. *                                    *
  12. *    THE ONLY DIFFERENCE IS THE FILE REQUESTERS:-            *
  13. *                                    *
  14. *    THE 2.0+ VERSION USES THE ASL LIBRARY                *
  15. *                                    *
  16. *    AND THE 1.3 VERSION USES THE REQ TOOLS LIBRARY            *
  17. *    WHICH IS COPYRIGHT OF Nico François                *
  18. *                                    *
  19. *    SEE END FOR GREETS .                        *
  20. *                                    *
  21. *    VERSION 1.1 IS THE SAME AS 1.0 BUT A FEW BUGS HAVE BEEN     *
  22. *    FIXED                                 *
  23. *    1. WHEN LOADING PICS OR BARS ,SOMETIMES IT WOULD FILL TO THE    *
  24. *    BOTTOM OF THE SCREEN THIS IS NOW FIXED                *
  25. *    2. THE DOCS FILE NOW TELLS YOU HOW TO SAVE COPPER BARS         *
  26. *                                    *
  27. *************************************************************************
  28.  
  29.                 ------------
  30.                 INTRODUCTION
  31.                 ------------
  32.  
  33.     DCPaint was wrote to make some of the color generation on the 
  34. copper easier . The takes a lot of time off programmers for example typing
  35. copper bar data in can take quite some time . 
  36.  
  37.                 
  38.                 ------
  39.                 BASICS
  40.                 ------
  41.  
  42.     The Amiga copper only supports 8 pixel definition if you fill
  43. color after color on the X axis this limits pictures to being blocky .
  44. DCPaint is not designed to support doing complex pictures .
  45.  
  46.                 
  47.                 ------------
  48.                 DRAWING AIDS
  49.                 ------------
  50.  
  51. When the package has loaded you will see some icons at the top right of 
  52. the sreen these are the drawing aids and are as follows :-
  53.  
  54.             +++++++++++++++++
  55.     PLOT A POINT    +    +    +    PLOT A POINT
  56.             +    +    +    CONTINUOUS
  57.             +++++++++++++++++
  58.     PLOT A LINE    +    +    +    SIMPLE FILL
  59.             +    +    +
  60.             +++++++++++++++++
  61.     DRAW LINE BOX    +    +    +    DRAW FILLED BOX
  62.             +    +    +
  63.             +++++++++++++++++
  64.     DRAW CIRCLE    +    +    +    DRAW ELLIPSE
  65.             +    +    +
  66.             +++++++++++++++++
  67.     DRAW 8*8 BLOCK    +    +    +    DRAW 16*16 BLOCK
  68.             +    +    +
  69.             +++++++++++++++++
  70.     DRAW SHADE    +    +    +    DRAW SHADE 8*8
  71.     POINT        +    +    +    BLOCK
  72.             +++++++++++++++++
  73.     PICK FORGROUND    +    +    +    PICK BACKGROUND
  74.     COLOR        +    +    +    COLOR
  75.             +++++++++++++++++
  76.     TURN ON/OFF    +    +    +    CLEAR SCREEN
  77.     COLOR FADING    +    +    +
  78.             +++++++++++++++++
  79.  
  80.  
  81.                 -----------
  82.                 DEFINITIONS
  83.                 -----------
  84.  
  85. Plot a Point .
  86. --------------
  87.  
  88.     Plots a point in the copper and updates the display straight away .
  89. Use the left button to plot in the forground color and the right mouse 
  90. button to plot in the background color .
  91.  
  92. Plot a Point Continuous .
  93. -------------------------
  94.  
  95.     Plots a point in the copper and updates the display when the mouse
  96. button has been released to give a bit faster drawing speed over the above.
  97. Use the left button to plot in the forground color and the right mouse 
  98. button to plot in the background color .
  99.     
  100. Plot a Line .
  101. -------------
  102.  
  103.     Plot a line on the copper using the left button for forground and
  104. the right button for background colors .
  105. When plotting a line you click on the point to start from and then you
  106. should see the mouse pointer change shape you the move to the place you
  107. want the line to go and click again and a line should be ploted from
  108. your first point to your second . 
  109.  
  110. Simple Fill .
  111. -------------
  112.  
  113.     Use the left button to fill an area in the forgeound color . This
  114. is a very simple routine and although not very acurate it fills at 
  115. (hopfully) an adequate speed . 
  116.  
  117. Draw Line Box .
  118. ---------------
  119.  
  120.     Draw a outlined box using left button for forground color and 
  121. right button for background color . To draw the box click where the
  122. top left of the box should start . The mouse pointer should change and
  123. then click on the lower right of where the box will end e.g corner to
  124. corner . the box should now be drawn .
  125.  
  126. Draw Filled Box .
  127. -----------------
  128.  
  129. Same as above but will fill the box in .
  130.  
  131. Draw Circle . 
  132. -------------
  133.  
  134.     Draw a circle using left button for forground color and right 
  135. button for background color . To plot the circle click on where you want
  136. the centre . The mouse pointer will change . Then move up or down for
  137. the required radius and click on that point and low and behold a circle
  138. will be drawn . 
  139.  
  140. Draw Ellipse . 
  141. --------------
  142.  
  143.     Draw a ellipse using left button for forground color and right 
  144. button for background color . To plot the ellipse click on where you want
  145. the centre . The mouse pointer will change . Then move up or down and left
  146. or right for the oval X and Y Radius's and click on that point and low 
  147. wow an ellipse will be draw
  148.  
  149. Draw 8*8 Block .
  150. ----------------
  151.  
  152.     Again (this is quite repetative) using left button for forground 
  153. color and right button for background color . plot a small box which is
  154. 8 pixles by 8 pixles . 
  155.  
  156. Draw 16*16 Block .
  157. ------------------
  158.  
  159.     Same as above but uses a box twice as big .
  160.     
  161. Draw Shade Point .
  162. ------------------
  163.  
  164.     Plot a point but finds average of color being used and color 
  165. already on the copper .
  166.     
  167. Draw Shade 8*8 Block .
  168. ----------------------
  169.  
  170.     Plot a box 8 pixles by 8 pixles but finds average of color being
  171. used and color already on the copper . 
  172.  
  173. Pick Forground Color .
  174. ----------------------
  175.  
  176.     Click on a color and it will be inserted into the forground color
  177.  
  178. Pick background Color .
  179. -----------------------
  180.  
  181.     Click on a color and it will be inserted into the background color
  182.  
  183. Turn On/Off Color Fading .
  184. --------------------------
  185.  
  186.     Switches on and off color fading when drawing lines,boxes ect .
  187. the color fade fade from the selected forground color to the selected 
  188. background color .
  189.  
  190. Clear Screen .
  191. --------------
  192.  
  193.     Fills the screen to the selected background color . If you 
  194. select the wrong color and clear the screen with it then go to the pallete
  195. and alter the first color (background) to the required color .
  196.  
  197.  
  198.                 ------
  199.                 COLORS
  200.                 ------
  201.  
  202.     under these gadgets you will find a pallete then two arrows 
  203. followed by another pallete .
  204.  
  205. The first pallete if the forground color .
  206.  
  207. The second pallete is the background color .
  208.  
  209. The two arrows switch between the 5 available palletes .
  210.  
  211.             ---------------------------
  212.                    MENUS
  213.             ---------------------------
  214.  
  215.     PROJECT .
  216.     ---------
  217.     
  218. CLR ALL .
  219. ---------
  220.     Clears screen same as gadget
  221.  
  222. LOAD . 
  223. ------                                      
  224.     Load a DCPaint picture from disk can be either bar or pic copper .
  225.     NOTE.
  226.     Because DCPaint uses ASCII format do not modify the files your
  227.     self until your sure there finished to your requirements .
  228. SAVE .
  229. ------
  230.     Saves a DCPaint file of a picture or copper bars .
  231. When saveing . If picture is selected then the full screen is saved as
  232. copper .
  233. When saveing as Copper bars Only the left side (position X=0 ) is used
  234. takeing the color at each line .
  235.                        
  236. DELETE .
  237. --------
  238.  
  239.     Delete's a file of disk .
  240.     
  241. ABOUT .
  242. -------
  243.     I wounder what this could be ......
  244.     
  245. QUIT .
  246. ------
  247.     Exit DCPaint ..
  248.     
  249.  
  250.     MOVEING .
  251.     ---------
  252.  
  253. UNSTAG-COPPER.
  254. --------------
  255.     Move all odd lines 4 places
  256.     
  257. STAG-COPPER.
  258. ------------
  259.     Move all odd lines 4 places back
  260.  
  261. UP.
  262. ---
  263.     Moves copper up a line to help positioning
  264. DOWN .
  265. ------
  266.     Moves copper down a line to help positioning
  267. LEFT .
  268. ------
  269.     Moves copper left a line to help positioning
  270. RIGHT .
  271. -------
  272.     Moves copper right a line to help positioning
  273.     
  274.  
  275.     EXTRAS.
  276.     -------
  277.     
  278. CO-ORDS.
  279. --------
  280.     Switches on and off co-ordinates .
  281.     
  282. HARDWARE REG .
  283. --------------
  284.     Specify the Hardware color register that the copper has to affect
  285.     
  286. PALLETE.
  287. --------
  288.     Brings up a pallet for changing colors in the 5 palletes and 
  289. copying colors . 
  290.  
  291. GET PICTURE .
  292. -------------
  293.     Loads and maps an IFF file from disk . IFF format must not be more
  294. than 5 planes and has to be a maximum of 320*256 .
  295.  
  296.                 ----------
  297.                    KEYS    
  298.                 ----------    
  299.                 
  300. HELP KEY .
  301. ----------
  302.  
  303.     Removes and shows the gadgets . so you can draw behind them .
  304.     
  305.     
  306.                 -----------
  307.                 USING NOTES
  308.                 -----------
  309.                 
  310.     Because I and filling every position in the copper you may find
  311. certain bits a bit slow . i tried to make them as usable as pos at the 
  312. time i hope you find it Ok . 
  313.  
  314. Because the DCPaint files are ASCII text for straight incluion the files
  315. DO NOT modify the files and then load them back into DCPaint . If your
  316. going to mod the files then do it when the your sure the Picture or bars
  317. are not going to need any more modifications . Hope this is not too
  318. much of a problem .
  319.  
  320. When the copper is saved a puts $FFE1,$FFFE in as a pal wait this may
  321. affect the copper when you use it ,so just remove if you have any problems
  322.  
  323.  
  324. Well i think thats iT so i'll just er go shall i 
  325.  
  326. If you want to contact me for anything then right to :
  327.                     
  328.                     O.S.D 
  329.                     100 GILDANE
  330.                     O.P.E
  331.                     HULL
  332.                     HU6 9AY
  333.                     
  334. P.S. This is probally my last A500 Compatible Programme As this was wrote
  335. on me A1200 and I had loads of Things Which the A500 Didnt like . So 
  336. From Now on I am Probably only coding the A1200 .....
  337.  
  338.  
  339. *************************************************************************
  340. *                                    *
  341. *    Greets ...                            *
  342. *                                    *
  343. *    ALL NERVE AXIS MEMBERS                         *
  344. *    (ROMBUST I FINALY GOT IT FINISHED)                *
  345. *    SCHITZO - CASE - CANDYMAN - TANGO - TANTALUS - KIWI - FINN    *
  346. *    PAZZA - LAZZER                             *
  347. *    ABSOLUTE - ADDICT - ALCATRAZ - ANALOG - ANDROMEDA - ANTHROX    *
  348. *    ATOMIC - BALANCE - CARILLION - CENTURA - COMPACT - COMPLEX    *
  349. *    CRIONICS - CRUSADERS - CRYPTOBURNERS - CRYSTAL - DAMONES    *
  350. *    DEADLINE - DELICIOUS - DEFEKT - DELIGHT - DESIRE - DEVILS    *
  351. *    DIGITAL - DREAMDEALERS - DUAL CREW - END OF CENTURY 1999    *
  352. *    ENDLESS PIRACY - EQUINOX - ENERGY - FAIRLIGHT - FATAL - FUTURA    *
  353. *    IMPULSE - INFECT - INTENSE - INTERACTIVE - JETSET - KEFRENS    *
  354. *    LASER DANCE - LEMON - LIQUID - LSD - MANITOU - MAJIC 12 -     *
  355. *    MELON DEZIGN - MEXX - MOTION - MOVEMENT - NOXIOUS - PANIC    *
  356. *    PARADISE - PARADOX - PARASITE - PHENOMA - PLASMA - PLEASURE    *
  357. *    PURE METAL CODERS - QUADRIGA - QUARTEX - QUARTZ - RAZOR 1911    *
  358. *    RAM JAM - REVENGE - SANITY - SCEPTIC - SCOOPEX -  SHINING    *
  359. *    SHINING 8 - SILENTS - SONIC - SPACEBALLS - SPREADPOINT         *
  360. *    STATIC BYTES - STELLAR - SUBSTANCE - SUPPLEX              *
  361. *    SURPRISE! PRODUCTIONS - TARKUS TEAM - TECH             *
  362. *    THE ELECTRONIC KNIGHTS - THE SPECIAL BROTHERS - TRANCE - TRIBE    *
  363. *    TRSI - VANISH - VIRTUAL DREAMS - VOODOO DESIGNS - ZENITH    *
  364. *************************************************************************
  365.  
  366.